string.htmlHTMLudog1TπùΔ§πùΔ§ÅÅ"° Monkeybread Realbasic plugin - Documentation - String

MBS Plugin Documentation

This is the documentation for the Realbasic Plugins from Monkeybreadsoftware.de. You find these plugins and the newest version of this document at http://www.monkeybreadsoftware.de/realbasic inside the plugins section.

This help was last updated on Freitag, 6. September 2002 and covers 2136 items: 126 classes, 2 controls and 583 global functions.

The list of the themes Global methods by category Global methods by name The list of the classes The list of the controls

CloneMemoryBlock(s as memoryblock[,len as integer]) as memoryblock

global method, Types Di, 6. Aug 2002
Mac OS Classic: Works. Mac OS Carbon: Works. Windows: Works.
Function: Clones the memoryblock.
Notes: May return nil on low memory conditions.

CloneString(s as string) as string

global method, Types Di, 6. Aug 2002
Mac OS Classic: Works. Mac OS Carbon: Works. Windows: Works.
Function: Clones the string.
Notes:
May return "" on low memory conditions.
The encoding of the string is copied in RB 4.5 or newer.

GetMemoryBlockLockCount(m as memoryblock) as integer

global method, Types Plugin version: 2.6 So, 1. Sep 2002
Mac OS Classic: Works. Mac OS Carbon: Works. Windows: Works.
Function: Returns how many references are pointing to a memoryblock object.
Notes:
none

GetPictureLockCount(p as picture) as integer

global method, Types Plugin version: 2.6 So, 1. Sep 2002
Mac OS Classic: Works. Mac OS Carbon: Works. Windows: Works.
Function: Returns how many references are pointing to a picture object.
Notes:
none

GetStringEncoding(s as string) as integer

global method, Types Mo, 15. Jul 2002
Mac OS Classic: Works. Mac OS Carbon: Works. Windows: Works.
Function: Returns the internal value for the encoding.
Notes:
Only usefull on Realbasic 4.5 and newer.
Some example values for encoding:
MacRoman 0Also for ASCII or binary data used.
WindowsLatin1&h0500ANSI codepage 1252
ISOLatin1&h0201ISO 8859-1
NextStepLatin&h0B01NextStep encoding
Unicode &h010016 bit Unicode
UTF8&h080001008 bit Unicode
Invalid&hFFFFFFFF

GetStringLockCount(s as string) as integer

global method, Types Plugin version: 2.6 So, 1. Sep 2002
Mac OS Classic: Works. Mac OS Carbon: Works. Windows: Works.
Function: Returns how many references are pointing to a string object.
Notes:
none

Hexstring(input as string, hexlen as integer, linelen as integer, linestart as string, lineend as string, spacer as string,filler as string) as string

global method, Types Plugin version: 2.6 Mi, 28. Aug 2002
Mac OS Classic: Works. Mac OS Carbon: Works. Windows: Works.
Function: Creates a hexadecimal string.
Example: s=Hexstring(sonstwasstring,2,10,"<",">"+chr(13)+chr(10),"","0")
Notes:
Fails if input="" or hexlen<1 or linelen<1 or on low memory conditions.
If filler is "", filler is set to "0".

Memory requirement is around 5 times the memory for input.
or exactly:
mem=20+linelen*hexlen*(1+len(filler))+2*((linelen*hexlen*len(filler)+len(lineend)+len(linestart))*(len(input)*2/hexlen))

(I hope this function is correct ;-)

MemoryBlockToString(s as memoryblock[,len as integer]) as string

global method, Types Di, 6. Aug 2002
Mac OS Classic: Works. Mac OS Carbon: Works. Windows: Works.
Function: Returns a copy of the content of the memoryblock as a string.
Notes:
May return "" on low memory conditions.
As some memoryblocks don't have a known length, you can provide one.

SetStringEncoding(s as string,encoding as integer)

global method, Types Di, 13. Aug 2002
Mac OS Classic: Works. Mac OS Carbon: Works. Windows: Works.
Function: Sets the internal value for the encoding.
Notes:
Only usefull on Realbasic 4.5 and newer.
Some example values for encoding:
MacRoman 0Also for ASCII or binary data used.
WindowsLatin1&h0500ANSI codepage 1252
ISOLatin1&h0201ISO 8859-1
NextStepLatin&h0B01NextStep encoding
Unicode &h010016 bit Unicode
UTF8&h080001008 bit Unicode
Invalid&hFFFFFFFF
Invalid&hFFFF

StringToMemoryBlock(s as string) as memoryblock

global method, Types Di, 6. Aug 2002
Mac OS Classic: Works. Mac OS Carbon: Works. Windows: Works.
Function: Returns a copy of the content of the string as a memoryblock.
Notes: May return nil on low memory conditions.

Contact

Written 2002 by Christian Schmitz. Feel free to ask or report mistakes to realbasic@macsw.de.
Thanks.

This resource fork intentionally left blank ˇˇ